How to Use

Заголовок страницы

У страницы заголовок должен состоять только из альфанумерических символов, чтоб система правильно переводила урл в путь. Ни точек, ни запятых, ни кавычек, ни других специальных символов быть не должно. Иначе система не сможет найти файл.

Метаданные страницы

Это такой блок деклараций, который ставится на страницу на самый-самый верх

---
title: Сказка о золотой рыбке
author: Александр Пушкин
date: 1833-10-02
tags: ["старуха", "корыто", "изба"]
---

Нас интересуют только date и tags, остальные система игнорирует.

Датировка страниц

Система сортирует посты по дате последней модификации файла, а по дате создания файла сортировать не умеет. На Линуксе такая информация в метаданных не хранится. Потому автоматическая сортировка страниц по дате не представляется возможным, хотя это очень полезная функция и нужная для блога, например. Потому дату написания поста надо вставлять вручную в блок деклараций в формате YYYY-MM-DD

data: 2021-10-11

Я приделал кнопки и для сортировки по дате публикации и времени последней модификации файла. Они просто добавляет/удаляют параметр для УРЛ /public/snips.php?sort=by_date. Если нажать, то появятся все датированные страницы, отсортированные по времени в обратном порядке

Таги

Таги вставляются в блок деклараций страницы таким образом

tags: ["таг1", "таг2", "таг3", "и так далее"]

Я б ставил таги не какие попало, а по теме для дополнительной навигации и поиска топиков. Я все еще думаю, сделать ли отдельную кнопку для топиков или одних тагов будет достатоно.

Фото-галерея

В фото-галерею картинки вставляются обычным образом кнопкой Insert image , а потом обрамляются хтмл коммент тагами <!-- ... -->, чтоб получилось как-то так

<!-- Веселые картинки --> 
<!--
![Путин](media/putin-65843089675.jpeg)
![Фото 1](media/foto1-111564934613.jpeg)
![Фото 2](media/foto1-92102326656.jpeg)
![Фото 3](media/foto3-167125531582.jpeg)
-->

и получается галерея с лайтбоксом. Лучше код располагать в одну строчку, чтоб потом sed, который читает текст построчно для заглавных отрывков, его не разъединил. Sed читает 15 строчек от начала, или сколько поставишь в файле snips.php.

Веселые картинки - это наименование галереи. В папке media надо сделать папку galleries, а в ней еще одну папку Веселые картинки, куда все свои фото из данного альбома и надо поместить. Дело в том, что такие фото в QOwnNotes, если их оставить в папке media, отображаются как orphaned, то есть ни с чем не связанные, а поскольку их много, то реально сиротливых файлов среди этой массы и не заметишь. Проверить галерею можно командой

find ./Public -name "*.md" -exec grep "Веселые картинки" {} \;

Если ничего не будет найдено, то вся галерея осиротелая, и ее можно безболезненно стереть.

Картинки с удаленного сервера не отображаются. Оно так лучше. Если хотите показать картинку с интернета, ее сначала надо скачать, а потом вставить в QOwnNotes кнопкой Insert image.

Поддерживается до 5 галерей на одной странице. Если хочешь больше, то добавь классов в файле gallery.css.

⤊